Favicon

You are here: Home > API Reference > App Distribution > Application > Retrieve distribution groups assigned to application

Retrieve distribution groups assigned to application

Required Permission: mad.application.management.listGroups

Retrieves the list of distribution groups or user segments that have been granted access to this application, showing which teams or employee groups can download and install builds.

GET
https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/groups 
curl -X GET "https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/groups" \
  -H "Authorization: Bearer <YOUR_API_KEY>"
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/groups", {
  method: "GET",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
  },
});

const data = await response.json();
import requests

response = requests.get(
    "https://api.applivery.io/v1/organizations/{organizationId}/apps/{applicationId}/groups",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)

data = response.json()

Request

Send your API key in the request header authorization
Example: Authorization: Bearer <token>

organizationId string
required
Unique identifier or URL-friendly slug for the organization that owns the applications to operate on, establishing organizational scope for all nested application operations.
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$
applicationId string
required
Unique identifier or URL-friendly slug for the specific application to retrieve, update, or delete.
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

Responses

200 Response application/json
status boolean optional
data object optional
items array [object] optional
Array of distribution groups or user segments that have been granted access to this application.
value string optional
Access control group identifier for organization-level permissions enabling role-based team management.
≤ 256 characters
{
    "status": true,
    "data": {
        "items": [
            {
                "value": "org.administrators"
            }
        ]
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4001
message string optional
Unauthorized
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}